home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / utils / file / managers / mc-3.2 / mc-3 / mc-3.2.1 / FAQ < prev    next >
Encoding:
Text File  |  1996-05-17  |  28.3 KB  |  879 lines
  1.  
  2.                    FREQUENTLY ASKED QUESTIONS WITH ANSWERS 
  3.                                        
  4.    Last modification Fri Aug 25 18:23:05 EET DST 1995  
  5.      _________________________________________________________________ 
  6.    
  7. Contents 
  8.  
  9.      * 1 Introduction and general information 
  10.           + 1.1 What is Midnight Commander? 
  11.           + 1.2 Who has written it? 
  12.           + 1.3 Does it run on my machine? 
  13.           + 1.4 Does it work with my terminal? 
  14.           + 1.5 What else do I need to run MC? 
  15.           + 1.6 Is Midnight Commander PD? Copyrighted? 
  16.      * 2 Network sources and resources 
  17.           + 2.1 Where can I get Midnight Commander? 
  18.           + 2.2 What mailing lists are there for Midnight Commander? 
  19.           + 2.3 Where should I look on the World Wide Web for MC stuff? 
  20.           + 2.4 Are the mailing lists archived anywhere? 
  21.           + 2.5 I don't have FTP access. Where can I get MC? 
  22.      * 3 Terminfo and termcap problems 
  23.           + 3.1 Why don't function keys (or any other key) work? 
  24.           + 3.2 Why don't line drawing characters work? 
  25.           + 3.3 How can I get colors? 
  26.           + 3.4 My color_xterm goes completely (or partially) black! 
  27.           + 3.5 Where can I get color_xterm? 
  28.           + 3.6 I got colors working with MC but the other programs don't
  29.             work at all anymore! 
  30.           + 3.7 Why are there both terminfo and termcap? Wouldn't one
  31.             database be enough? 
  32.      * 4 Command line problems 
  33.           + 4.1 How can I access command line history? 
  34.           + 4.2 How can I add the plus character (+) on the command line?
  35.           + 4.3 How can I complete commands, file names, variable names
  36.             and so on? 
  37.      * 5 Virtual file systems 
  38.           + 5.1 How can I see the contents of a tar archive? 
  39.           + 5.2 How do I get out of a tar archive? 
  40.           + 5.3 How do I do anonymous ftp with MC? 
  41.           + 5.4 How do I do non-anonymous ftp with MC? 
  42.           + 5.5 How do I close an ftp connection? 
  43.      * 6 Other common problems 
  44.           + 6.1 Why does the ESC key behave funny? 
  45.      * 7 Development 
  46.           + 7.1 What are those mc-2.4.xx versions people keep talking
  47.             about? 
  48.           + 7.2 When will mc-3.0. be released? 
  49.           + 7.3 What new features will be in mc-3.0? 
  50.           + 7.4 Do I dare to use a development version? 
  51.           + 7.5 How can I report a bug/request for a feature? 
  52.           + 7.6 How can I join the development? 
  53.           + 7.7 Why has MC got so trivial bugs every now and then? 
  54.      * 8 Administrative information 
  55.           + 8.1 Authorship 
  56.           + 8.2 File formats 
  57.           + 8.3 Feedback is invited 
  58.           + 8.4 Disclaimer and copyright 
  59.      * 9 Index 
  60.        
  61.     
  62.      _________________________________________________________________ 
  63.    
  64.                    1 INTRODUCTION AND GENERAL INFORMATION
  65.                                        
  66. 1.1 What is Midnight Commander?
  67.  
  68.    
  69.    
  70.    The Midnight Commander is a user-friendly yet powerful file manager
  71.    and visual shell, useful to novice and guru alike. It provides a
  72.    clear, user-friendly, and somewhat protected interface to a Unix
  73.    system while making many frequent file operations more efficient and
  74.    preserving the full power of the command prompt. You will wonder how
  75.    you could ever live without it. 
  76.    
  77.    For more thorough description take a look at the announcement of
  78.    Midnight Commander 2.0. 
  79.    
  80. 1.2 Who has written it?
  81.  
  82.    
  83.    
  84.    Midnight Commander was started Miguel de Icaza and he is the
  85.    maintainer of the package. Other authors have joined the project
  86.    later: 
  87.      * Mauricio Plaza (early releases, retired) 
  88.      * Janne Kukonlehto (joined Sep 27 1994, retired Mar 8 1995) 
  89.      * Radek Doulik (joined Oct 30 1994) 
  90.      * Fred Leeflang (joined Nov 2 1994) 
  91.      * Dugan Porter (joined Dec 1 1994) 
  92.      * Jakub Jelinek (joined Feb 8 1995) 
  93.      * Ching Hui (joined Jun 27 1995)
  94.        
  95.    
  96.    
  97.    Alessandro Rubini has been specially helpful with with debugging and
  98.    enhancing of the mouse support. John Davis has made his S-Lang library
  99.    available to us and answered many questions about it. 
  100.    
  101.    The photographs of the authors are available as: 
  102.    
  103.      http://stekt.oulu.fi/~jtklehto/mc/authors.html 
  104.      
  105.    
  106.    
  107.    Many people have contributed bug reports, feature suggestions and
  108.    small code bits (alphabetical order): 
  109.      * Erwin van Eijk 
  110.      * Torben Fjerdingstad 
  111.      * Massimo Fontanelli 
  112.      * Jean-Daniel Luiset 
  113.      * Wim Osterholt 
  114.      * Antonio Palama (DOS port) 
  115.      * Thomas Pundt 
  116.      * Vadim Sinolits 
  117.      * Jon Stevens 
  118.        
  119. 1.3 Does it run on my machine?
  120.  
  121.    
  122.    
  123.    Midnight Commander uses GNU autoconfigure, so you should be able to
  124.    run it on most (if not all) Unix clones. Following configurations have
  125.    been tested: 
  126.      * i386-*-linux1.0, i386-*-linux1.1, i386-*-linux1.2 
  127.      * mips-sgi-irix5.2 
  128.      * mips-sgi-irix5.3 
  129.      * mips-dec-ultrix4.3 
  130.      * rs6000-ibm-aix3.2.5 
  131.      * sparc-sun-sunos4.1 
  132.      * sparc-sun-solaris2.3 
  133.      * sparc-sun-netbsd1.0 
  134.      * hppa-hp-hpux9 
  135.      * hppa-hp-hpux7 
  136.      * m68k-apple-aux 
  137.      * mc88110-aviion-dgux5.4 
  138.        
  139.    
  140.    
  141.    There is also a preliminary Ms-Dos port at ftp.nuclecu.unam.mx:
  142.    /linux/local/DOS/ (Is there a Ms-Dos binary?). 
  143.    
  144. 1.4 Does it work with my terminal?
  145.  
  146.    
  147.    
  148.    Because Midnight Commander is a full screen program it doesn't run on
  149.    dummy terminals but anything more advanced will do (like vt100). If
  150.    your terminal works with vi, emacs, elm or pine it will work with
  151.    Midnight Commander. 
  152.    
  153.    The XView and Tk versions currently under development will require an
  154.    X terminal. 
  155.    
  156. 1.5 What else do I need to run MC?
  157.  
  158.    
  159.    
  160.    You need ncurses-1.8.5.2 from ftp.nuclecu.unam.mx: /linux/local/. 
  161.    
  162.    You can get along with other curses libraries it but results may not
  163.    be pretty or even usable. 
  164.    
  165.    With version 2.4.xx or later you don't need curses if you give
  166.    "--with-slang" flag to the configure. 
  167.    
  168.    If you want to use mouse on the Linux console you need General Purpose
  169.    Mouse server from iride.unipv.it: /pub/gpm/. You need nothing extra to
  170.    use mouse on xterm. 
  171.    
  172.    To compile the XView version (currently under development) you need
  173.    XView library. Xpm library and X11 non-rectangular shape extensions
  174.    are recommended. 
  175.    
  176.    To compile the Tk version (currently under development) you need
  177.    Tk-4.0 libraries. Compilation of the Tk version won't be easy. Contact
  178.    Miguel for details. 
  179.    
  180. 1.6 Is Midnight Commander PD? Copyrighted?
  181.  
  182.    
  183.    
  184.    Midnight Commander is under GNU Public License which basically means
  185.    that you may freely copy, change and distribute it, but that you may
  186.    not impose any restrictions on further distribution, and that you must
  187.    make the source code available. This is not the same as Public Domain.
  188.    For details, the GNU license is included in the Midnight Commander
  189.    source distribution (the COPYING file). 
  190.    
  191.    Midnight Commander is nowadays officially a part of GNU project. All
  192.    the authors of the Midnight Commander have given all their rights on
  193.    the program to the Free Software Foundation. 
  194.    
  195.                        2 NETWORK SOURCES AND RESOURCES
  196.                                        
  197. 2.1 Where can I get Midnight Commander?
  198.  
  199.    
  200.    
  201.    Source is available at following sites: 
  202.      * sunsite.unc.edu and mirrors:
  203.        /pub/Linux/utils/file/managers/mc-2.1.tar.gz 
  204.      * ftp.nuclecu.unam.mx: /linux/local/mc-2.1.tar.gz 
  205.        
  206.    
  207.    
  208.    There are also precompiled binaries available at ftp.nuclecu.unam.mx:
  209.    /linux/local/bin-dist/. 
  210.    
  211. 2.2 What mailing lists are there for Midnight Commander?
  212.  
  213.    
  214.    
  215.    Following mailing lists discuss about Midnight Commander: 
  216.    
  217.    mc
  218.           General discussion of the Midnight Commander 
  219.           
  220.    mc-digest
  221.           The mc list, in digest format 
  222.           
  223.    mc-announce
  224.           Major announcements about the Commander 
  225.           
  226.    mc-patch
  227.           The latest Commander patches (4-8 per week) 
  228.           
  229.    mc-devel
  230.           Technical development discussion 
  231.           
  232.    mc-chat
  233.           Non-MC related chatting by the developers (closed to new
  234.           comers) 
  235.           
  236.    
  237.    
  238.    To subscribe, send e-mail to majordomo@roxanne.nuclecu.unam.mx with
  239.    the following line in the body of the message: 
  240.  
  241.     subscribe <list-name> [optional-address]
  242.  
  243.    
  244.    
  245.    Replace <list-name> with the name of the list you want to subscribe
  246.    and [optional-address] with your email address. 
  247.    
  248. 2.3 Where should I look on the World Wide Web for MC stuff?
  249.  
  250.    
  251.    
  252.    There is a WWW page for Midnight Commander. The URL is: 
  253.    
  254.      http://stekt.oulu.fi/~jtklehto/mc/ 
  255.      
  256.    
  257.    
  258.    The WWW page features MC screen shots, photographs from authors,
  259.    mailing list archive and a few other things. 
  260.    
  261. 2.4 Are the mailing lists archived anywhere?
  262.  
  263.    
  264.    
  265.    The mc and mc-devel lists are archived on the World Wide Web page (see
  266.    the previous question). Other lists are not currently archived though
  267.    Miguel keeps a private archive. Contact him if you want copies of past
  268.    messages. 
  269.    
  270. 2.5 I don't have FTP access. Where can I get MC?
  271.  
  272.    
  273.    
  274.    Many Linux CD-ROMs include Midnight Commander. For example, Slackware,
  275.    Yggdrasil, S.U.S.E. and Jurix include version 2.1 and RedHad/Caldera
  276.    includes version 1.2. 
  277.    
  278.                        3 TERMINFO AND TERMCAP PROBLEMS
  279.                                        
  280. 3.1 Why don't function keys (or any other key) work?
  281.  
  282.    
  283.    
  284.    Your terminfo or termcap database has missing or incorrect definitions
  285.    for function keys. Type "mc -V" to see what curses library is being
  286.    used. If the result is "using the ncurses library" you should install
  287.    one of the enhanced terminfo databases included in the Midnight
  288.    Commander source distribution. For example, if you are using xterm
  289.    type "tic xterm.ti". 
  290.    
  291.    The official termcap and terminfo databases are available here: 
  292.    
  293.      http://www.ccil.org/~esr/ncurses.html 
  294.      
  295.    
  296.    
  297.    If your copy of MC is not compiled to use Ncurses see the manual page
  298.    of your curses library about how to change the termcap database
  299.    (/etc/termcap). The termcap database is not fully compatible with
  300.    terminfo but you can use the MC enhanced terminfo databases as a
  301.    model for your changes. 
  302.    
  303. 3.2 Why don't line drawing characters work?
  304.  
  305.    
  306.    
  307.    There are three subcases: 
  308.      * Lines are shown as ASCII characters like this 
  309.  
  310.       +---------+
  311.       |         |
  312.       +---------+
  313.    Possible reason is 1, 2 or 3. 
  314.      * Lines are shown as lower case characters like this 
  315.  
  316.       lqqqqqqqqqk
  317.       x         x
  318.       mqqqqqqqqqj
  319.    Possible reason is 2 or 3. 
  320.      * Lines are shown as blanks or missing characters. Possible reason
  321.        is 3 or 4. 
  322.        
  323.    
  324.    
  325.    The reason for the problem is one of following: 
  326.     1. Your curses library might not support line drawing characters.
  327.        Ncurses and System V curses do support them, BSD curses doesn't. 
  328.     2. Your terminal might not support line drawing characters. Vt100
  329.        compatible terminals, xterm and color_xterm do support them. 
  330.     3. Your terminfo or termcap database might have missing or incorrect
  331.        definations for line drawing characters. See the previous question
  332.        (the one about function keys). 
  333.     4. Your terminal font might not support line drawing characters. Try
  334.        changing the font.
  335.        
  336. 3.3 How can I get colors?
  337.  
  338.    
  339.    
  340.    First, check that your terminal supports color. Color_xterm, rxvt and
  341.    Linux console do support, most other terminals don't. You can test
  342.    color support with following simple C program: 
  343.  
  344.     #include <stdio.h>
  345.  
  346.     int main (void){
  347.         printf ("\033[32m Hello world! \033[m\n");
  348.         return 0;
  349.     }
  350.  
  351.    
  352.    
  353.    Compile and run it. If you see "Hello world!" text in green your
  354.    terminal supports color, otherwise not (however, for color_xterm see
  355.    also the next question). 
  356.    
  357.    Second, check that you are using Ncurses or the Slang library (type
  358.    "mc -V" to find out), some System V curses implementations do support
  359.    color, most don't. 
  360.    
  361.    The Slang version supports color, too. If you are using version 2.4.xx
  362.    or newer you might want to give "--with-slang" flag to the configure
  363.    before compilation. The following paragraph about terminfo databases
  364.    isn't valid for the Slang version. Type "mc -c" to force color support
  365.    with the Slang version or set the environment variable COLORTERM to
  366.    any value. 
  367.    
  368.    Third, check that your terminfo database supports color. If not you
  369.    should install one of the enhanced terminfo databases included in the
  370.    Midnight Commander source distribution. See the question before the
  371.    previous question (the one about function keys). 
  372.    
  373.    Fourth, set the TERM environment variable so that you use the correct
  374.    terminfo database. If you use color_xterm (or rxvt): 
  375.    
  376.    If your shell is sh, bash, ksh or zsh: 
  377.           TERM=xterm-color; export TERM 
  378.           
  379.    If your shell is csh or tcsh: 
  380.           setenv TERM xterm-color
  381.           
  382.    
  383.    
  384.    Newer versions of Ncurses require that you use xtermc instead of
  385.    xterm-color. 
  386.    
  387.    If you use Linux console the correct value for TERM is linux or
  388.    console. 
  389.    
  390. 3.4 My color_xterm goes completely (or partially) black!
  391.  
  392.    
  393.    
  394.    Some color_xterm terminals define all colors as black instead of the
  395.    standard ANSI colors. This makes them go completely black when you try
  396.    to use Midnight Commander with colors. 
  397.    
  398.    You will have to override the defaults. Create a file "color.defaults"
  399.    which has the following contents: 
  400.  
  401.     color_xterm*color0:           Black
  402.     color_xterm*color1:           Red
  403.     color_xterm*color2:           Green
  404.     color_xterm*color3:           Yellow
  405.     color_xterm*color4:           Blue
  406.     color_xterm*color5:           Magenta
  407.     color_xterm*color6:           Cyan
  408.     color_xterm*color7:           White
  409.     color_xterm*background:       White
  410.     color_xterm*foreground:       Black
  411.  
  412.    
  413.    
  414.    (replace color_xterm with the name of your color_xterm, color_xterm
  415.    mentions its name in its title bar) 
  416.    
  417.    Now type: 
  418.  
  419.     xrdb -merge color.defaults
  420.  
  421.    
  422.    
  423.    Alternatively you can add the suggested contents of the color.defaults
  424.    file to your .Xdefaults or .Xresources file (or what ever the name of
  425.    your X configuration file is). Or you can replace your non-ANSI
  426.    color_xterm with an ANSI color_xterm. 
  427.    
  428. 3.5 Where can I get color_xterm?
  429.  
  430.    
  431.    
  432.    Try ftp.x.org: /contrib/utilities/colour_xterm.tar.gz. 
  433.    
  434. 3.6 I got colors working with MC but the other programs don't work at all
  435. anymore!
  436.  
  437.    
  438.    
  439.    Midnight Commander uses terminfo database (when compiled with Ncurses)
  440.    but many other programs use termcap database. If you set the TERM
  441.    environment variable to a value which has no corresponding entry in
  442.    termcap database those programs stop working. You should add the new
  443.    value of TERM to the termcap database. 
  444.    
  445.    Example: If you have set TERM to xterm-color locate from /etc/termcap
  446.    the line which starts: 
  447.  
  448.     xterm|vs100|xterm terminal emulator
  449.  
  450.    
  451.    
  452.    Change it to start: 
  453.  
  454.     xterm|xterm-color|vs100|xterm terminal emulator
  455.  
  456. 3.7 Why are there both terminfo and termcap? Wouldn't one database be enough?
  457.  
  458.    
  459.    
  460.    You might want to read the Unix-haters handbook at
  461.    http://web.kaleida.com/u/hopkins/unix-haters.html. It lists many
  462.    more reasons why Unix sucks. 
  463.    
  464.    The Slang version of the Midnight Commander, available on newer 2.4.xx
  465.    versions allows you to configure which terminal database you want to
  466.    use with the "--with-termcap" and "--with-terminfo" flags of
  467.    configure. If you don't specify them, the configure script will try to
  468.    use terminfo if available otherwise it will use termcap. 
  469.    
  470.                            4 COMMAND LINE PROBLEMS
  471.                                        
  472. 4.1 How can I access command line history?
  473.  
  474.    
  475.    
  476.    You can browse previous commands with M-p and M-n. Alternatively, you
  477.    can summon the command history listbox by pressing F9 c h. 
  478.    
  479. 4.2 How can I add the plus character (+) on the command line?
  480.  
  481.    
  482.    
  483.    The plus key is the hotkey for the select files command. If want to
  484.    add a literal plus on to the command line you must quote it. Press C-q
  485.    before pressing +. 
  486.    
  487. 4.3 How can I complete commands, file names, variable names and so on?
  488.  
  489.    
  490.    
  491.    Completion is a version 3.0 feature. 
  492.    
  493.    Just press M-Tab. Press M-Tab again to get a listbox if there are
  494.    multiple possible completions. 
  495.    
  496.                            5 VIRTUAL FILE SYSTEMS
  497.                                        
  498.    
  499.    
  500.    Virtual file systems are features of the forthcoming version 3.0. 
  501.    
  502. 5.1 How can I see the contents of a tar archive?
  503.  
  504.    
  505.    
  506.    Tar support is a version 3.0 feature. 
  507.    
  508.    If you use keyboard just move the selection bar on the tar file and
  509.    press enter. 
  510.    
  511.    If you use mouse just doubleclick on the tar file. 
  512.    
  513.    If these procedures don't work, your .mc.ext file is faulty. Replace
  514.    it with one from the MC source distribution. 
  515.    
  516.    You can also enter a tar archive by typing "cd tar:filename.tar.gz"
  517.    where filename.tar.gz is the name of the archive. 
  518.    
  519.    The recognized suffixes for tar archives are .tar, .tar.gz and .tgz.
  520.    If your tar archive uses different suffix you have to rename it. 
  521.    
  522. 5.2 How do I get out of a tar archive?
  523.  
  524.    
  525.    
  526.    Tar support is a version 3.0 feature. 
  527.    
  528.    Just press enter on the toplevel ".." file or chdir to a non-tar
  529.    directory. Just typing "cd" with no parameters is enough (it will take
  530.    you to your home directory). 
  531.    
  532. 5.3 How do I do anonymous ftp with MC?
  533.  
  534.    
  535.    
  536.    FTP support is a version 3.0 feature. 
  537.    
  538.    Just type "cd ftp://hostname" where hostname is the name of the host
  539.    you want to connect. Alternatively, select FTP link from the Left or
  540.    Right menu and type the name of the host you want to connect. 
  541.    
  542. 5.4 How do I do non-anonymous ftp with MC?
  543.  
  544.    
  545.    
  546.    FTP support is a version 3.0 feature. 
  547.    
  548.    Non-anonymous ftp works just like the anonymous ftp but you give the
  549.    login name with the host name. For example, type "cd
  550.    ftp://username@hostname". 
  551.    
  552. 5.5 How do I close an ftp connection?
  553.  
  554.    
  555.    
  556.    FTP support is a version 3.0 feature. 
  557.    
  558.    Just chdir to a non-ftp directory. Just typing "cd" with no parameters
  559.    is enough (it will take you to your home directory). 
  560.    
  561.                            6 OTHER COMMON PROBLEMS
  562.                                        
  563. 6.1 Why does the ESC key behave funny?
  564.  
  565.    
  566.    
  567.    Midnight Commander uses the ESC key as a prefix for simulating the
  568.    Meta and Alt keys (for terminals which don't have Meta or Alt). For
  569.    example, pressing ESC-a is the same as pressing Meta-a. In addition
  570.    most terminals use ESC for internal representation of arrow keys,
  571.    function keys and other enhanced keys. If you want to use ESC to
  572.    cancel things you have to press it twice i. e. ESC-ESC. If you find
  573.    this cumbersome you can generally use F10 to cancel. Alternatively
  574.    turn on the old_esc_mode setting in the ~/.mc.ini file. The
  575.    old_esc_mode setting makes ESC work as a prefix only if another key is
  576.    pressed within 0.5 seconds. After 0.5 seconds the ESC key cancels.
  577.    There is no way to make ESC cancel immediately (if we want to be able
  578.    to use arrows keys and function keys). 
  579.    
  580.    Of course, these ESC limitations don't concern the forthcoming XView
  581.    and Tk versions of the Midnight Commander. 
  582.    
  583.                                 7 DEVELOPMENT
  584.                                        
  585. 7.1 What are those mc-2.4.xx versions people keep talking about?
  586.  
  587.    
  588.    
  589.    The newest public release is mc-2.1. The mc-2.4.xx releases are
  590.    development versions. The next public release will be mc-3.0 (which
  591.    will probably be immediately followed by mc-3.1). 
  592.    
  593. 7.2 When will mc-3.0. be released?
  594.  
  595.    
  596.    
  597.    We are currently doing the final touches on mc-3.0 and it will be
  598.    released soon, maybe in September. 
  599.    
  600. 7.3 What new features will be in mc-3.0?
  601.  
  602.    
  603.    
  604.    The Midnight Commander development has run into problems with the many
  605.    bugs in the curses libraries. Therefore we have switched to Slang.
  606.    This will solve many of our current problems. 
  607.    
  608.    Here are the features that have already been done: 
  609.      * To make it easier to code the Slang support the whole Midnight
  610.        Commander was migrated to a widget oriented user interface. It's
  611.        now also possible to teach the Commander about the escape
  612.        sequences sent by your terminal without having to modify your
  613.        system terminal databases. 
  614.      * A virtual file system switch (vfs) that gives you a network based
  615.        file system (mcfs), a read only tar and compressed tar file
  616.        systems. A ftp file system is on the works. 
  617.      * Command and filename completion is finished. 
  618.      * An Advanced Chown command, much nicer than the regular chown and
  619.        chmod dialog boxes we had. 
  620.      * The internal file viewer features: growing buffers, piped input
  621.        from arbitrary programs (so you can look at nicely formated man
  622.        pages just with a mouse click), bold and underline attributes. 
  623.      * Better color management (now you can specify the intensity of the
  624.        colors).
  625.        
  626.    
  627.    
  628.    We will begin the code freeze as soon as we get this parts finished: 
  629.      * An FTP file system on top of our VFS. 
  630.      * XView, Guile/Tk, Tcl/Tk versions of the program (though Miguel
  631.        might decide to leave these for mc-4.0). 
  632.        
  633. 7.4 Do I dare to use a development version?
  634.  
  635.    
  636.    
  637.    I am afraid you have to answer to this question yourself. Development
  638.    versions seldom cause data loss but they have usually got many bugs.
  639.    It's up to you to judge whether new features outweight the bugs. 
  640.    
  641. 7.5 How can I report a bug/request for a feature?
  642.  
  643.    
  644.    
  645.    You might first want to get the newest development version to see if
  646.    the bug is fixed or the feature is added already. 
  647.    
  648.    Send your report/request to mc-devel@roxanne.nuclecu.unam.mx or
  649.    mc@roxanne.nuclecu.unam.mx. These mailing lists are the most certain
  650.    way to contact the developers. Remember to mention if you are not on
  651.    the mailing list so that you will receive a copy of replies (by
  652.    default the replies are sent to the list only in order to avoid
  653.    duplicate copies). 
  654.    
  655.    Give as much details as possible. A too long message is a lot better
  656.    than a too short message. 
  657.    
  658.    For segmentation faults a stack backtrace is appreciated. You can
  659.    produce stack backtrace as follows: 
  660.      * If segmentation fault produced a core file:
  661.          1. Load the core file by typing "gdb mc core" or "dbx mc core". 
  662.          2. Type "where". 
  663.          3. Cut and paste the results to your message.
  664.      * If segmentation fault didn't produce a core file:
  665.          1. Load mc by typing "gdb mc" or "dbx mc". 
  666.          2. Start mc by typing "run". 
  667.          3. Try to reproduce the segmentation fault by doing whatever you
  668.             did last time when the segmentation fault occurred. 
  669.          4. Type "where". 
  670.          5. Cut and paste the results to your message. 
  671.          6. For the future you might want to check out what is the
  672.             command in your shell to allow producing of the core files.
  673.             Usually it is "limit coredumpsize unlimited" or "ulimit
  674.             coredumpsize". 
  675.             
  676. 7.6 How can I join the development?
  677.  
  678.    
  679.    
  680.    Congratulations on your decision to join the development! More
  681.    developers are always needed. 
  682.    
  683.    To join the development just code the feature you want to add and send
  684.    your patch to Miguel. Email address is miguel@roxanne.nuclecu.unam.mx.
  685.    Before you start coding check the latest development version. It might
  686.    be that your feature has already been implemented. 
  687.    
  688.    If Miguel likes your patch he will include it in the next development
  689.    version and you will get your name to contributors section. After you
  690.    have sent a few more patches Miguel will promote your name to the
  691.    authors section. 
  692.    
  693.    Note that because the authors of the Midnight Commander have given all
  694.    their rights on the program to the Free Software Foundation you will
  695.    have to do the same if you contribute non-trivial patches. Otherwise
  696.    we have to reject your patches in order to avoid copyright problems. 
  697.    
  698. 7.7 Why has MC got so trivial bugs every now and then?
  699.  
  700.    
  701.    
  702.    Development versions have usually got many bugs because we prefer
  703.    rapid development to slow bureaucracy. However, we always try to get
  704.    rid of bugs before releasing the next public version (that's why we
  705.    divide versions to development versions and public versions in the
  706.    first place). 
  707.    
  708.                         8 ADMINISTRATIVE INFORMATION
  709.                                        
  710. 8.1 Authorship
  711.  
  712.    
  713.    
  714.    This FAQ is written by Janne Kukonlehto. Parts of it originate from
  715.    Ian Jackson, Miguel de Icaza and Dugan Porter. 
  716.    
  717. 8.2 File formats
  718.  
  719.    
  720.    
  721.    This FAQ has originally been written in a HTML-like format. It has
  722.    been converted to a real HTML by a perl script. The HTML version has
  723.    been rendered to ASCII by Lynx. 
  724.    
  725.    The HTML file is available at
  726.    http://stekt.oulu.fi/~jtklehto/mc/faq.html. The ASCII file is posted
  727.    on the mc mailing list. Alternatively, you can produce a ASCII version
  728.    with Lynx from the HTML file yourself (Press p (print) and choose the
  729.    (usually) topmost option: "Save to a local file"). The HTML-like
  730.    version is available at http://stekt.oulu.fi/~jtklehto/mc/faq.tmpl and
  731.    the conversion script at
  732.    http://stekt.oulu.fi/~jtklehto/mc/indxhtml.pl. 
  733.    
  734.    The perl script adds standard HTML header and footer elements and
  735.    creates the Contents and Index sections and internal links. 
  736.    
  737. 8.3 Feedback is invited
  738.  
  739.    
  740.    
  741.    Please send me your comments on this FAQ. There are probably a lot of
  742.    things to add. My email address is jtklehto@paju.oulu.fi. You can also
  743.    use the feedback form at 
  744.    
  745.      http://stekt.oulu.fi/~jtklehto/mc/comments.html 
  746.      
  747.    
  748.    
  749.    Note: I will not add bug reports to this FAQ because they will become
  750.    obsolete very quickly (or eventually, at least). So don't request
  751.    them. 
  752.    
  753.    If you have a lot of additions and changes to contribute I would
  754.    appreciate if you send them as unified patch against faq.tmpl (the
  755.    HTML-like version). However, other formats will do, too. 
  756.    
  757.    This FAQ has existed for half an year now and I have received one
  758.    contribution and one request for closer information how to contribute.
  759.    
  760. 8.4 Disclaimer and copyright
  761.  
  762.    
  763.    
  764.    Note that this document is provided as is. The information in it is
  765.    not warranted to be correct; you use it at your own risk. This
  766.    Midnight Commander Frequently Asked Questions with Answers document is
  767.    Copyright 1995 by Janne Kukonlehto <jtklehto@paju.oulu.fi>. 
  768.    
  769.    You are free to use this FAQ in any way which will benefit the
  770.    Midnight Commander project. All other use is strictly forbidden.
  771.    Alternatively, you can use this FAQ according to GNU Public License
  772.    (see the COPYING file in the Midnight Commander source distribution).
  773.    This FAQ is not Public Domain.  
  774.      _________________________________________________________________ 
  775.    
  776.                                    9 INDEX
  777.                                        
  778.    Alt
  779.           6.1 
  780.           
  781.    Announcement
  782.           1.1 
  783.           
  784.    ANSI
  785.           3.4 
  786.           
  787.    Authors
  788.           1.2, 7.6 
  789.           
  790.    Autoconfigure
  791.           1.3 
  792.           
  793.    Binaries
  794.           2.1 
  795.           
  796.    Bug reports
  797.           8.3 
  798.           
  799.    Cancel
  800.           6.1 
  801.           
  802.    CD-ROMs
  803.           2.5 
  804.           
  805.    Color.defaults
  806.           3.4 
  807.           
  808.    Color_xterm
  809.           3.2, 3.3, 3.4, 3.5 
  810.           
  811.    Configurations
  812.           1.3 
  813.           
  814.    Console
  815.           3.3, 3.3 
  816.           
  817.    Contributors
  818.           1.2, 7.6 
  819.           
  820.    Description
  821.           1.1 
  822.           
  823.    ESC
  824.           6.1 
  825.           
  826.    Font
  827.           3.2 
  828.           
  829.    License
  830.           1.6 
  831.           
  832.    Maintainer
  833.           1.2, 8.3 
  834.           
  835.    Meta
  836.           6.1 
  837.           
  838.    Old_esc_mode
  839.           6.1 
  840.           
  841.    Prefix
  842.           6.1 
  843.           
  844.    Rxvt
  845.           3.3 
  846.           
  847.    Source
  848.           2.1, 8.2 
  849.           
  850.    TERM
  851.           3.3, 3.6 
  852.           
  853.    Vt100
  854.           3.2 
  855.           
  856.    WWW
  857.           2.3, 8.3 
  858.           
  859.    Xrdb
  860.           3.4 
  861.           
  862.    Xterm
  863.           3.1, 3.2 
  864.           
  865.    Xterm-color
  866.           3.3, 3.6 
  867.           
  868.    Xtermc
  869.           3.3 
  870.           
  871.     
  872.      _________________________________________________________________ 
  873.    
  874.    [JTKL home] [MC home]  
  875.      _________________________________________________________________ 
  876.    
  877.    
  878.     jtklehto@stekt.oulu.fi 
  879.